home *** CD-ROM | disk | FTP | other *** search
/ HPAVC / HPAVC CD-ROM.iso / PWAECD10.ZIP / ECDIZ.DOC < prev    next >
Text File  |  1995-08-04  |  8KB  |  166 lines
  1. +----------------------------------------------------------------------------+
  2. | Enhanced CleanDIZ v1.0                                                     |
  3. | Written by Drew [PWA]                                                      |
  4. | Docs last updated 08-01-95                                                 |
  5. +----------------------------------------------------------------------------+
  6.  
  7.  
  8. +-----------------------------------------------------------------------------+
  9. | 0. Table of Contents                                                        |
  10. +-----------------------------------------------------------------------------+
  11.     1. Introduction
  12.     2. Packaging
  13.     3. Installation
  14.     4. Configuration
  15.     5. Included Batch Files
  16.     6. Other Program Information
  17.     7. Contacting the Author
  18.  
  19.  
  20. +----------------------------------------------------------------------------+
  21. | 1. Introduction                                                            |
  22. +----------------------------------------------------------------------------+
  23.     Enhanced CleanDIZ (ECDIZ) is a utility which will strip unnecessary
  24. and unwanted lines from the FILE_ID.DIZ description files.  Although it was
  25. designed with FILE_ID.DIZ in mind, in actuality, it works with *any* type of
  26. file.  That means you can strip any set of lines from any type of file.
  27.  
  28.     Its selectable features include:
  29.  
  30.         - Keeping original FILE_ID.DIZ timestamp
  31.         - Ignoring upper/lower case
  32.         - Strip blank lines
  33.         - Strip PCBoard @-color codes (ie: @X1F)
  34.         - Strip Forum Pipe color codes (ie: |14)
  35.         - Strip exact line matches (default: key)
  36.         - Strip high-ascii characters
  37.         - Strip lines with no text
  38.  
  39.     Other attractions:
  40.  
  41.         - Extremely fast execution (386 or better required)
  42.         - No built-in limit to the number of lines to strip
  43.         - All command-line driven; no config files to muck with
  44.         - Keeps pkzip & pkunzip calls external (so you have more
  45.           control over the pkzip/pkunzip options, or even if you
  46.           want to use some other archive compressor)
  47.  
  48.     This documentation will be focused on FILE_ID.DIZ and PCBoard.  Any
  49. other particular combination will be up to your imagination.
  50.  
  51.  
  52. +-----------------------------------------------------------------------------+
  53. | 2. Packaging                                                                |
  54. +-----------------------------------------------------------------------------+
  55.     Your zip file should contain the following files:
  56.  
  57.         ECDIZ.EXE      Main executable for 386's and up.
  58.         ECDIZ2.EXE     Executable for 286's.
  59.         EZDIZ.DOC      Documentation (you are reading it now).
  60.         STRIP.DIZ      Data file containing tag lines for stripping.
  61.         TEST.BAT       Sample batch file used for testing.
  62.         UPLOAD.BAT     Sample batch file for upload processing.
  63.         OTHERDJP.DOC   Other stuff I've written.
  64.         FILE_ID.DIZ    File (zip) description.
  65.         PWA.NFO        PWA info file.
  66.         TSP.NFO        My bbs ad.
  67.  
  68.     If any of these files are missing, be warned that you may have a copy
  69. that has been tampered with.  If you have any extra files, they are
  70. extraneous and unnecessary.
  71.  
  72.     Typically, my bbs ad may not be there, which is not a problem.  However,
  73. the idiots who contribute this to the fidonet backbone (usually originating
  74. from the Clipper Workshop BBS) edit the FILE_ID.DIZ, remove PWA.NFO and
  75. OTHERDJP.DOC, and insert their own bbs ad which is bigger than most ppe's.
  76. Just be aware, since who knows what other stupidities they may pull.
  77.  
  78.  
  79. +----------------------------------------------------------------------------+
  80. | 3. Installation                                                            |
  81. +----------------------------------------------------------------------------+
  82.     The best place to install this would be just after a successful CRC
  83. test somewhere during processing an uploaded file.  Refer to UPLOAD.BAT for
  84. an example of what to do.
  85.  
  86.     ECDIZ.EXE is compiled for 386 and better processors.  ECDIZ2.EXE is for
  87. 286's.  Pick the one that is most applicable.  If you have anything less than
  88. a 286, you are in the stone age. :)
  89.  
  90.  
  91. +----------------------------------------------------------------------------+
  92. | 4. Configuration                                                           |
  93. +----------------------------------------------------------------------------+
  94.     Typing "ECDIZ" on the command line will provide you with all the
  95. various options available:
  96.  
  97.     They should all be self-explanatory and if not, the best way to find
  98. out what an option does is to try it (see TEST.BAT).
  99.  
  100.     "STRIP.DIZ" contains the file used for removing unwanted lines.  By
  101. default, lines in this file match lines contained within lines in the diz
  102. file being processed by "key".  That means if a diz line contains (but not
  103. necessarily matching exactly) a line in STRIP.DIZ, the diz line will be
  104. removed.  If you want to use exact matches, use the "-E" option.
  105.  
  106.  
  107. +----------------------------------------------------------------------------+
  108. | 5. Included Batch Files                                                    |
  109. +----------------------------------------------------------------------------+
  110.     Two batch files have been included as examples of possible usages
  111. of ECDIZ.  All batch files are for DOS 6.x.
  112.  
  113. UPLOAD.BAT
  114.  
  115.     Shows how and where to install ECDIZ as part of the upload processing
  116.     sequence.  Uses PCBoard with PKZip as an example.
  117.  
  118. TEST.BAT
  119.  
  120.     Used for testing new ECDIZ options.  Saves you from typing everything
  121.     on the command line. :)
  122.  
  123.  
  124. +----------------------------------------------------------------------------+
  125. | 6. Other Program Information                                               |
  126. +----------------------------------------------------------------------------+
  127.     This utility is FREEWARE.  No registration is required and there are
  128. no nag screens.  However, comments, suggestions and donations will certainly
  129. be accepted. :)  If you find this little utility useful, feel free drop me a
  130. quick note.
  131.  
  132.     I only know of three other programs in the past which did something
  133. similar to this.  One was from Q-Tip, another from Aegis, and the third from 
  134. some public domain(?) person.  All of them either simply did not have enough
  135. options to meet the extremely annoying (lame) tag lines that people add to
  136. diz's nowadays, or they were limited to only *.ZIP files.  Even though most
  137. systems and most archive files are in ZIP format anyway, I felt that the
  138. presence of this flexibility was worthwhile to have archive procedures not
  139. built-in.
  140.  
  141.     ECDIZ was written and compiled using Borland C++ v3.1.  It has been
  142. tested on DOS 6.x, OS/2 v3.0, and Novell Netware 3.12.  It should also work
  143. on other DOS compatible operating systems.
  144.  
  145.     (Author's node: Actually, ECDIZ is an extremely trimmed down version
  146. of my DIR-shrinker, which may or may not be released in the future).
  147.  
  148.  
  149. +----------------------------------------------------------------------------+
  150. | 7. Contacting the Author                                                   |
  151. +----------------------------------------------------------------------------+
  152.     I am rarely on IRC, so don't be a dork and bother other PWA members.
  153. Don't ask for source, and don't ask to be a distribution site, because we
  154. don't have any.
  155.  
  156. You can reach me in the following ways:
  157.  
  158.     Internet email : drew@xinet.com
  159.  
  160.     My BBS         : The Silicon Phalanx, 310-575-8567
  161.  
  162.     Other          : Attitude Net, PPEnet
  163.  
  164. Peace,
  165. --Drew
  166.